lets-plot 4.4.1__cp39-cp39-macosx_11_0_arm64.whl → 4.5.0__cp39-cp39-macosx_11_0_arm64.whl

lets_plot/plot/geom_function_.py

@@ -75,7 +75,8 @@ def _get_mapping(mapping):
     return aes(**{**x_mapping_dict, **mapping_dict, **y_mapping_dict})
 
 
-def geom_function(mapping=None, *, data=None, stat=None, geom=None, position=None, show_legend=None, manual_key=None,
+def geom_function(mapping=None, *, data=None, stat=None, geom=None, position=None, show_legend=None, inherit_aes=None,
+                  manual_key=None,
                   tooltips=None,
                   fun=None, xlim=None, n=None,
                   color_by=None,
@@ -105,12 +106,15 @@ def geom_function(mapping=None, *, data=None, stat=None, geom=None, position=Non
         'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` 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.
     manual_key : str or `layer_key`
         The key to show in the manual legend.
         Specify text for the legend label or advanced settings using the `layer_key()` function.
     tooltips : `layer_tooltips`
         Result of the call to the `layer_tooltips()` function.
         Specify appearance, style and content.
+        Set tooltips='none' to hide tooltips from the layer.
     fun : function
         A function of one variable in Python syntax.
     xlim : list of float, default=[0.0, 1.0]
@@ -136,10 +140,15 @@ def geom_function(mapping=None, *, data=None, stat=None, geom=None, position=Non
 
     - x : x-axis value.
     - alpha : transparency level of a layer. Accept values between 0 and 1.
-    - color (colour) : color of the geometry. For more info see https://lets-plot.org/python/pages/aesthetics.html#color-and-fill.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'. For more info see https://lets-plot.org/python/pages/aesthetics.html#line-types.
+    - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
+    - linetype : type of the line. Accept codes or names (0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'), a hex string (up to 8 digits for dash-gap lengths), or a list pattern [offset, [dash, gap, ...]] / [dash, gap, ...]. For more info see `Line Types <https://lets-plot.org/python/pages/aesthetics.html#line-types>`__.
     - size : line width.
 
+    ----
+
+    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()`.
+
     Examples
     --------
     .. jupyter-execute::
@@ -199,6 +208,7 @@ def geom_function(mapping=None, *, data=None, stat=None, geom=None, position=Non
                  stat=fun_stat,
                  position=position,
                  show_legend=show_legend,
+                 inherit_aes=inherit_aes,
                  manual_key=manual_key,
                  sampling=None,
                  tooltips=tooltips,

lets_plot/plot/geom_imshow_.py

@@ -391,6 +391,7 @@ def geom_imshow(image_data, cmap=None, *,
         xmax=ext_x1,
         ymax=ext_y1,
         show_legend=show_legend,
+        inherit_aes=False,
         color_by=color_by if (show_legend and greyscale) else None,
     )
 

lets_plot/plot/geom_livemap_.py

@@ -205,6 +205,7 @@ def _prepare_tiles(tiles: Optional[Union[str, dict]]) -> Optional[dict]:
 
     if isinstance(tiles, dict):
         if tiles.get(MAPTILES_KIND) == TILES_RASTER_ZXY:
+            _warn_deprecated_tiles(tiles)
             return {
                 OPTIONS_MAPTILES_KIND: TILES_RASTER_ZXY,
                 OPTIONS_MAPTILES_URL: tiles[MAPTILES_URL],
@@ -240,6 +241,7 @@ def _prepare_tiles(tiles: Optional[Union[str, dict]]) -> Optional[dict]:
             raise ValueError('URL for tiles service is not set')
 
         if get_global_val(MAPTILES_KIND) == TILES_RASTER_ZXY:
+            _warn_deprecated_tiles(None)
             return {
                 OPTIONS_MAPTILES_KIND: TILES_RASTER_ZXY,
                 OPTIONS_MAPTILES_URL: get_global_val(MAPTILES_URL),
@@ -269,6 +271,36 @@ def _prepare_tiles(tiles: Optional[Union[str, dict]]) -> Optional[dict]:
     raise ValueError('Tile provider is not set.')
 
 
+def _warn_deprecated_tiles(tiles: Union[dict, None]):
+    # TODO: Remove this warning in future releases.
+
+    if tiles is None:
+        maptiles_url = get_global_val(MAPTILES_URL)
+    else:
+        maptiles_url = tiles[MAPTILES_URL]
+
+    if not isinstance(maptiles_url, str):
+        return
+    if not maptiles_url.startswith("https://cartocdn_[abc].global.ssl.fastly.net/"):
+        return
+    if 'base-midnight' not in maptiles_url and 'base-antique' not in maptiles_url and 'base-flatblue' not in maptiles_url:
+        return
+
+    if tiles is None:
+        if not has_global_value(MAPTILES_ATTRIBUTION):
+            return
+        maptiles_attribution = get_global_val(MAPTILES_ATTRIBUTION)
+    else:
+        maptiles_attribution = tiles[MAPTILES_ATTRIBUTION]
+
+    if not isinstance(maptiles_attribution, str):
+        return
+    if not maptiles_attribution.endswith('map data: <a href="https://www.openstreetmap.org/copyright">© OpenStreetMap contributors</a> <a href="https://carto.com/attributions#basemaps">© CARTO</a>, <a href="https://carto.com/attributions">© CARTO</a>'):
+        return
+
+    print(f"WARN: The tileset is no longer available and the corresponding constant will be removed in future releases.")
+
+
 def _prepare_location(location: Union[str, List[float]]) -> Optional[dict]:
     if location is None:
         return None

lets_plot/plot/gggrid_.py

@@ -3,10 +3,10 @@
 # Use of this source code is governed by the MIT license that can be found in the LICENSE file.
 #
 
-from lets_plot.plot.core import FeatureSpec, PlotSpec
+from lets_plot.plot.core import PlotSpec
+from ._global_theme import _get_global_theme
 from .subplots import SupPlotsLayoutSpec
 from .subplots import SupPlotsSpec
-from ._global_theme import _get_global_theme
 
 __all__ = ['gggrid']
 
@@ -20,7 +20,7 @@ def gggrid(plots: list, ncol: int = None, *,
            vspace: float = None,
            fit: bool = None,
            align: bool = None
-           ):
+           ) -> SupPlotsSpec:
     """
     Combine several plots on one figure, organized in a regular grid.
 
@@ -119,7 +119,8 @@ def gggrid(plots: list, ncol: int = None, *,
 
     def _strip_theme_if_global(fig):
         # Strip global theme options from plots in grid (see issue: #966).
-        if global_theme_options is not None and fig is not None and 'theme' in fig.props() and fig.props()['theme'] == global_theme_options.props():
+        if global_theme_options is not None and fig is not None and 'theme' in fig.props() and fig.props()[
+            'theme'] == global_theme_options.props():
             if isinstance(fig, PlotSpec):
                 fig = PlotSpec.duplicate(fig)
                 fig.props().pop('theme')

lets_plot/plot/ggtb_.py

@@ -7,5 +7,50 @@ from .core import FeatureSpec
 __all__ = ['ggtb']
 
 
-def ggtb():
+def ggtb() -> FeatureSpec:
+    """
+    Add a toolbar to a chart.
+
+    This function adds a toolbar containing three tool-buttons (pan, rubber-band zoom,
+    and center-point zoom) to a chart. Each tool uses mouse-drag for its
+    specific functionality. Additionally, the mouse wheel can be used for zooming
+    in and out, regardless of the selected tool.
+
+    The toolbar includes:
+
+    - Pan: Drag to move the plot.
+    - Rubber-band zoom: Drag to define a rectangular area to zoom into.
+    - Center-point zoom: Drag up or down to zoom in or out from a center point.
+    - Reset button: Click to reset the plot and tools to their original state.
+
+    Double-clicking anywhere on the plot resets it to its original coordinates,
+    regardless of whether a tool is selected or not.
+
+    Limitations:
+
+    - The toolbar does not work with interactive maps.
+    - The toolbar is not compatible with GGBunch.
+    - The toolbar cannot be used with plots using a polar coordinate system.
+
+    Returns
+    -------
+    `FeatureSpec`
+        Toolbar feature specification.
+
+    Examples
+    --------
+    .. jupyter-execute::
+        :linenos:
+        :emphasize-lines: 8
+
+        import numpy as np
+        from lets_plot import *
+        LetsPlot.setup_html()
+        x = np.linspace(-2 * np.pi, 2 * np.pi, 100)
+        y = np.sin(x)
+        ggplot({'x': x, 'y': y}, aes(x='x', y='y')) + \\
+            geom_point() + \\
+            ggtb()
+
+    """
     return FeatureSpec(kind='ggtoolbar', name=None)

lets_plot/plot/label.py

@@ -82,12 +82,12 @@ def xlab(label):
 
 def ylab(label):
     """
-    Add label to the y axis.
+    Add label to the y-axis.
 
     Parameters
     ----------
     label : str
-        The text for the y axis label.
+        The text for the y-axis label.
 
     Returns
     -------

lets_plot/plot/sampling.py

@@ -232,7 +232,7 @@ def sampling_group_random(n, seed=None):
     return _sampling('group_random', n=n, seed=seed)
 
 
-def sampling_vertex_vw(n):
+def sampling_vertex_vw(n, polygon=None):
     """
     Simplify a polyline using the Visvalingam-Whyatt algorithm.
 
@@ -241,6 +241,11 @@ def sampling_vertex_vw(n):
     n : int
         Number of items to return.
 
+    polygon : bool, default=None
+        If True, the input data is considered as a polygon rings.
+        If False, the input data is considered as a polyline.
+        None for auto-detection.
+
     Returns
     -------
     `FeatureSpec`
@@ -275,10 +280,10 @@ def sampling_vertex_vw(n):
             geom_contour(sampling=sampling_vertex_vw(150))
 
     """
-    return _sampling('vertex_vw', n=n)
+    return _sampling('vertex_vw', n=n, polygon=polygon)
 
 
-def sampling_vertex_dp(n):
+def sampling_vertex_dp(n, polygon=None):
     """
     Simplify a polyline using the Douglas-Peucker algorithm.
 
@@ -287,6 +292,11 @@ def sampling_vertex_dp(n):
     n : int
         Number of items to return.
 
+    polygon : bool, default=None
+        If True, the input data is considered as a polygon rings.
+        If False, the input data is considered as a polyline.
+        None for auto-detection.
+
     Returns
     -------
     `FeatureSpec`
@@ -321,7 +331,7 @@ def sampling_vertex_dp(n):
             geom_contour(sampling=sampling_vertex_dp(100))
 
     """
-    return _sampling('vertex_dp', n=n)
+    return _sampling('vertex_dp', n=n, polygon=polygon)
 
 
 def _sampling(name, **kwargs):

lets_plot/plot/scale.py

@@ -56,7 +56,7 @@ def scale_shape(solid=True, name=None, breaks=None, labels=None, lablim=None, li
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -143,7 +143,7 @@ def scale_manual(aesthetic, values, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -239,7 +239,7 @@ def scale_color_manual(values, name=None, breaks=None, labels=None, lablim=None,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -314,7 +314,7 @@ def scale_fill_manual(values, name=None, breaks=None, labels=None, lablim=None,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -387,7 +387,7 @@ def scale_size_manual(values, name=None, breaks=None, labels=None, lablim=None,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -462,7 +462,7 @@ def scale_shape_manual(values, name=None, breaks=None, labels=None, lablim=None,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -537,7 +537,7 @@ def scale_linetype_manual(values, name=None, breaks=None, labels=None, lablim=No
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -613,7 +613,7 @@ def scale_alpha_manual(values, name=None, breaks=None, labels=None, lablim=None,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -706,7 +706,7 @@ def scale_continuous(aesthetic, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     scale_mapper_kind : {'identity', 'color_gradient', 'color_gradient2', 'color_gradientn', 'color_hue', 'color_grey', 'color_brewer', 'color_cmap', 'size_area'}
         The type of the scale.
         If None (the default) and the scale is color, then 'color_gradient' will be used.
@@ -793,7 +793,7 @@ def scale_fill_continuous(name=None, breaks=None, labels=None, lablim=None,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     scale_mapper_kind : {'color_gradient', 'color_gradient2', 'color_gradientn', 'color_hue', 'color_grey', 'color_brewer', 'color_cmap'}
         The type of color scale.
         If None (the default), then 'color_gradient' will be used.
@@ -872,7 +872,7 @@ def scale_color_continuous(name=None, breaks=None, labels=None, lablim=None, lim
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     scale_mapper_kind : {'color_gradient', 'color_gradient2', 'color_gradientn', 'color_hue', 'color_grey', 'color_brewer', 'color_cmap'}
         The type of color scale.
         If None (the default), then 'color_gradient' will be used.
@@ -959,7 +959,7 @@ def scale_gradient(aesthetic, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1042,7 +1042,7 @@ def scale_fill_gradient(low=None, high=None, name=None, breaks=None, labels=None
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1122,7 +1122,7 @@ def scale_color_gradient(low=None, high=None, name=None, breaks=None, labels=Non
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1209,7 +1209,7 @@ def scale_gradient2(aesthetic, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1297,7 +1297,7 @@ def scale_fill_gradient2(low=None, mid=None, high=None, midpoint=0, name=None, b
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1382,7 +1382,7 @@ def scale_color_gradient2(low=None, mid=None, high=None, midpoint=0, name=None,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1464,7 +1464,7 @@ def scale_gradientn(aesthetic, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1546,7 +1546,7 @@ def scale_color_gradientn(colors=None, name=None, breaks=None, labels=None, labl
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1625,7 +1625,7 @@ def scale_fill_gradientn(colors=None, name=None, breaks=None, labels=None, labli
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1713,7 +1713,7 @@ def scale_hue(aesthetic, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1803,7 +1803,7 @@ def scale_fill_hue(h=None, c=None, l=None, h_start=None, direction=None, name=No
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1889,7 +1889,7 @@ def scale_color_hue(h=None, c=None, l=None, h_start=None, direction=None, name=N
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -1973,7 +1973,7 @@ def scale_discrete(aesthetic, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     scale_mapper_kind : {'identity', 'color_gradient', 'color_gradient2', 'color_gradientn', 'color_hue', 'color_grey', 'color_brewer', 'color_cmap', 'size_area'}
         The type of the scale.
         If None (the default) and the scale is color, then 'color_brewer' will be used.
@@ -2062,7 +2062,7 @@ def scale_fill_discrete(direction=None,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     scale_mapper_kind : {'color_gradient', 'color_gradient2', 'color_gradientn', 'color_hue', 'color_grey', 'color_brewer', 'color_cmap'}
         The type of color scale.
         If None (the default), then 'color_brewer' will be used.
@@ -2144,7 +2144,7 @@ def scale_color_discrete(direction=None,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     scale_mapper_kind : {'color_gradient', 'color_gradient2', 'color_gradientn', 'color_hue', 'color_grey', 'color_brewer', 'color_cmap'}
         The type of color scale.
         If None (the default), then 'color_brewer' will be used.
@@ -2231,7 +2231,7 @@ def scale_grey(aesthetic, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -2316,7 +2316,7 @@ def scale_fill_grey(start=None, end=None, name=None, breaks=None, labels=None, l
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -2396,7 +2396,7 @@ def scale_color_grey(start=None, end=None, name=None, breaks=None, labels=None,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -2504,7 +2504,7 @@ def scale_brewer(aesthetic, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -2607,7 +2607,7 @@ def scale_fill_brewer(type=None, palette=None, direction=None, name=None, breaks
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -2707,7 +2707,7 @@ def scale_color_brewer(type=None, palette=None, direction=None, name=None, break
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -2824,7 +2824,7 @@ def scale_viridis(aesthetic, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -2933,7 +2933,7 @@ def scale_fill_viridis(alpha=None, begin=None, end=None, direction=None, option=
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -3037,7 +3037,7 @@ def scale_color_viridis(alpha=None, begin=None, end=None, direction=None, option
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -3116,7 +3116,7 @@ def scale_alpha(range=None, name=None, breaks=None, labels=None, lablim=None, li
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -3190,7 +3190,7 @@ def scale_size(range=None, name=None, breaks=None, labels=None, lablim=None, lim
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -3265,7 +3265,7 @@ def scale_size_area(max_size=None, name=None, breaks=None, labels=None, lablim=N
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -3345,7 +3345,7 @@ def scale_linewidth(range=None, name=None, breaks=None, labels=None, lablim=None
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -3419,7 +3419,7 @@ def scale_stroke(range=None, name=None, breaks=None, labels=None, lablim=None, l
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------

lets_plot/plot/scale_colormap_mpl.py

@@ -93,7 +93,7 @@ def scale_cmapmpl(aesthetic, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -176,7 +176,7 @@ def scale_fill_cmapmpl(cmap, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -255,7 +255,7 @@ def scale_color_cmapmpl(cmap, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------