lets-plot 4.5.0rc2__cp311-cp311-macosx_11_0_arm64.whl → 4.5.2__cp311-cp311-macosx_11_0_arm64.whl

lets_plot/plot/geom_function_.py

@@ -114,6 +114,7 @@ def geom_function(mapping=None, *, data=None, stat=None, geom=None, position=Non
     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]
@@ -139,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. 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 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::

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/ggtb_.py

@@ -17,6 +17,7 @@ def ggtb() -> FeatureSpec:
     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.
@@ -26,6 +27,7 @@ def ggtb() -> FeatureSpec:
     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.
@@ -39,15 +41,16 @@ def ggtb() -> FeatureSpec:
     --------
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 7
+        :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())
+        ggplot({'x': x, 'y': y}, aes(x='x', y='y')) + \\
+            geom_point() + \\
+            ggtb()
 
     """
     return FeatureSpec(kind='ggtoolbar', name=None)

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
     -------

lets_plot/plot/scale_identity_.py

@@ -54,7 +54,7 @@ def scale_identity(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
     -------
@@ -124,7 +124,7 @@ def scale_color_identity(name=None, breaks=None, labels=None, lablim=None, limit
         - '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
     -------
@@ -133,11 +133,7 @@ def scale_color_identity(name=None, breaks=None, labels=None, lablim=None, limit
 
     Notes
     -----
-    Input data expected: list of strings containing:
-
-    - names of colors (e.g. 'green'),
-    - hex codes of colors (e.g. 'x00ff00'),
-    - css colors (e.g. 'rgb(0, 255, 0)').
+    For more info about input data format, see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
 
     Examples
     --------
@@ -197,7 +193,7 @@ def scale_fill_identity(name=None, breaks=None, labels=None, lablim=None, limits
         - '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
     -------
@@ -206,11 +202,7 @@ def scale_fill_identity(name=None, breaks=None, labels=None, lablim=None, limits
 
     Notes
     -----
-    Input data expected: list of strings containing:
-
-    - names of colors (e.g. 'green'),
-    - hex codes of colors (e.g. 'x00ff00'),
-    - css colors (e.g. 'rgb(0, 255, 0)').
+    For more info about input data format, see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
 
     Examples
     --------
@@ -270,7 +262,7 @@ def scale_shape_identity(name=None, breaks=None, labels=None, lablim=None, limit
         - '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
     -------
@@ -343,7 +335,7 @@ def scale_linetype_identity(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
     -------
@@ -419,7 +411,7 @@ def scale_alpha_identity(name=None, breaks=None, labels=None, lablim=None, limit
         - '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
     -------
@@ -489,7 +481,7 @@ def scale_size_identity(name=None, breaks=None, labels=None, lablim=None, limits
         - '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
     -------
@@ -559,7 +551,7 @@ def scale_linewidth_identity(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
     -------
@@ -627,7 +619,7 @@ def scale_stroke_identity(name=None, breaks=None, labels=None, lablim=None, limi
         - '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
     -------