Fix links for 1d plots in docs (#242)

Author: cvanelteren

docs/1dplots.py

@@ -136,11 +136,11 @@
 #
 # The 1D :class:`~ultraplot.axes.PlotAxes` commands recognize `pandas`_
 # and `xarray`_ data structures. If you omit dependent variable coordinates,
-# the commands try to infer them from the `pandas.Series`, `pandas.DataFrame`,
-# or `xarray.DataArray`. If you did not explicitly set the *x* or *y* axis label
+# the commands try to infer them from the :class:`pandas.Series`, :class:`pandas.DataFrame`,
+# or :class:`xarray.DataArray`. If you did not explicitly set the *x* or *y* axis label
 # or :ref:`legend or colorbar <ug_guides_loc>` label(s), the commands
-# try to retrieve them from the `pandas.DataFrame` or `xarray.DataArray`.
-# The commands also recognize `pint.Quantity` structures and apply
+# try to retrieve them from the :class:`pandas.DataFrame` or :class:`xarray.DataArray`.
+# The commands also recognize :class:`pint.Quantity` structures and apply
 # unit string labels with formatting specified by :rc:`unitformat`.
 #
 # These features restore some of the convenience you get with the builtin
@@ -151,14 +151,14 @@
 #
 # .. note::
 #
-#    For every plotting command, you can pass a `~xarray.Dataset`, :class:`~pandas.DataFrame`,
+#    For every plotting command, you can pass a :class:`~xarray.Dataset`, :class:`~pandas.DataFrame`,
 #    or `dict` to the `data` keyword with strings as data arguments instead of arrays
 #    -- just like matplotlib. For example, ``ax.plot('y', data=dataset)`` and
 #    ``ax.plot(y='y', data=dataset)`` are translated to ``ax.plot(dataset['y'])``.
 #    This is the preferred input style for most `seaborn`_ plotting commands.
-#    Also, if you pass a `pint.Quantity` or :class:`~xarray.DataArray`
-#    containing a `pint.Quantity`, UltraPlot will automatically call
-#    `~pint.UnitRegistry.setup_matplotlib` so that the axes become unit-aware.
+#    Also, if you pass a :class:`pint.Quantity` or :class:`~xarray.DataArray`
+#    containing a :class:`pint.Quantity`, UltraPlot will automatically call
+#    :func:`~pint.UnitRegistry.setup_matplotlib` so that the axes become unit-aware.
 
 # %%
 import xarray as xr
@@ -354,9 +354,9 @@
 #    has the area :rcraw:`lines.markersize` squared. These minimum and maximum marker
 #    sizes can also be specified manually with the `smin` and `smax` keywords,
 #    analogous to `vmin` and `vmax` used to scale the color array `c`. This feature
-#    can be disabled by passing ``absolute_size=True`` to :func:`~ultraplot.axes.Axes.scatter`
-#    or :func:`~ultraplot.axes.Axes.scatterx`. This is done automatically when `seaborn`_
-#    calls :func:`~ultraplot.axes.Axes.scatter` internally.
+#    can be disabled by passing ``absolute_size=True`` to :func:`~ultraplot.axes.PlotAxes.scatter`
+#    or :func:`~ultraplot.axes.PlotAxes.scatterx`. This is done automatically when `seaborn`_
+#    calls :func:`~ultraplot.axes.PlotAxes.scatter` internally.
 
 # %%
 import ultraplot as uplt
@@ -513,9 +513,9 @@
 #    while UltraPlot bar widths are expressed in step size-relative units by
 #    default. For example, ``width=1`` with a dependent coordinate step
 #    size of ``2`` fills 100% of the space between each bar rather than 50%. This
-#    can be disabled by passing ``absolute_width=True`` to :func:`~ultraplot.axes.Axes.bar`
-#    or :func:`~ultraplot.axes.Axes.barh`. This is done automatically when `seaborn`_ calls
-#    :func:`~ultraplot.axes.Axes.bar` or :func:`~ultraplot.axes.Axes.barh` internally.
+#    can be disabled by passing ``absolute_width=True`` to :func:`~ultraplot.axes.PlotAxes.bar`
+#    or :func:`~ultraplot.axes.PlotAxes.barh`. This is done automatically when `seaborn`_ calls
+#    :func:`~ultraplot.axes.PlotAxes.bar` or :func:`~ultraplot.axes.PlotAxes.barh` internally.
 
 # %%
 import ultraplot as uplt

docs/api.rst

@@ -53,7 +53,6 @@ Axes classes
 .. automodsumm:: ultraplot.axes
    :toctree: api
 
-
 Top-level functions
 ===================
 

docs/conf.py

@@ -371,6 +371,7 @@ def __getattr__(self, name):
     (master_doc, "UltraPlot.tex", "UltraPlot Documentation", "UltraPlot", "manual"),
 ]
 
+primary_domain = "py"
 
 # -- Options for manual page output ------------------------------------------