Merge master

Author: lukelbd

docs/_static/custom.css

@@ -1,5 +1,5 @@
 /* This file contains edits to the RTD theme CSS style
- * sheets. The latter requires a _templates/layout.html file.
+ * sheets. Requires a _templates/layout.html file.
  * https://learn.shayhowe.com/advanced-html-css/complex-selectors/
  * - item is tag e.g. <item></item>
  * - #item is id e.g. <p id="item"></p>
@@ -424,4 +424,3 @@ a:visited,
 #lightdark-label:hover input:checked + div.btn-neutral:before {
   content: "Light mode";
 }
-

docs/_static/custom.js

@@ -1,9 +1,10 @@
-/* Toggle light and dark theme */
-/* See: https://dev.to/ananyaneogi/create-a-dark-light-mode-switch-with-css-variables-34l8 */
-/* CSS files from: https://github.com/richleland/pygments-css */
-/* Toggle functions and event handler */
-/* Best light themes: pastie, friendly, murhpy */
-/* Best dark themes: monokai, paraiso-dark */
+/* Toggle light and dark theme
+ * See: https://dev.to/ananyaneogi/create-a-dark-light-mode-switch-with-css-variables-34l8
+ * CSS files from: https://github.com/richleland/pygments-css
+ * Toggle functions and event handler
+ * Best light themes: pastie, friendly, murhpy
+ * Best dark themes: monokai, paraiso-dark
+ */
 var regex = /(.*)\/.*(\.css$)/i
 const toggleSwitch = document.getElementById('lightdark-checkbox');
 const pygmentsLink = document.getElementById('pygments-style');

docs/why.rst

@@ -25,7 +25,7 @@ No more boilerplate
 
    <h3>Problem</h3>
 
-Power users often need to change lots of plot settings all at once. In matplotlib, this requires a bunch of one-liner setters and getters, like `~matplotlib.axes.Axes.set_title`. 
+Power users often need to change lots of plot settings all at once. In matplotlib, this requires a bunch of one-liner setters and getters, like `~matplotlib.axes.Axes.set_title`.
 
 This workflow is verbose and often confusing. It can be unclear whether settings can be changed from a `~matplotlib.figure.Figure` setter, an `~matplotlib.axes.Axes` setter, an `~matplotlib.axis.XAxis` or `~matplotlib.axis.YAxis` setter, or a miscellaneous bulk function like `~matplotlib.axes.Axes.tick_params`.
 
@@ -72,7 +72,11 @@ Matplotlib and cartopy introduce a bunch of classes with verbose names like `~ma
 
 *Other* parts of the matplotlib API were designed with this in mind.
 `Native axes projections <https://matplotlib.org/3.1.1/api/projections_api.html>`__,
-`axis scale classes <https://matplotlib.org/3.1.0/gallery/scales/scales.html>`__, and `colormap instances <https://matplotlib.org/3.1.1/gallery/color/colormap_reference.html>`__ are referenced with "registered" string names,
+`axis scale classes <https://matplotlib.org/3.1.0/gallery/scales/scales.html>`__,
+`box style classes <https://matplotlib.org/3.1.1/api/_as_gen/matplotlib.patches.FancyBboxPatch.html?highlight=boxstyle>`__, `arrow style classes <https://matplotlib.org/3.1.1/api/_as_gen/matplotlib.patches.FancyArrowPatch.html?highlight=arrowstyle>`__,
+`arc style classes <https://matplotlib.org/3.1.1/api/_as_gen/matplotlib.patches.ConnectionStyle.html?highlight=class%20name%20attrs>`__, and
+`backends <https://matplotlib.org/faq/usage_faq.html#what-is-a-backend>`__
+are referenced with "registered" string names,
 as are `basemap projection types <https://matplotlib.org/basemap/users/mapsetup.html>`__.
 If these are already "registered", why not "register" everything else?
 
@@ -180,7 +184,7 @@ individual subplots and along contiguous subplots on the edge of the figure:
 * Outer colorbars and legends don't mess up the subplot layout or subplot aspect ratios, since `~proplot.subplots.FlexibleGridSpec` permits variable spacing between subplot rows and columns. This is critical e.g. if you have a colorbar between columns 1 and 2 but nothing between columns 2 and 3.
 * `~proplot.subplots.Figure` and `~proplot.axes.Axes` colorbar widths are specified in *physical* units rather than relative units. This makes colorbar thickness independent of figure size and easier to get just right.
 
-The colorbar and legend commands also add several new features, like colorbars-from-lines and centerd-row legends. And to make `~proplot.axes.Axes` `~proplot.axes.Axes.colorbar` consistent with `~proplot.axes.Axes` `~proplot.axes.Axes.legend`, you can also now draw *inset* colorbars. See :ref:`Colorbars and legends` for details.
+The colorbar and legend commands also add several new features, like colorbars-from-lines and centered-row legends. And to make `~proplot.axes.Axes` `~proplot.axes.Axes.colorbar` consistent with `~proplot.axes.Axes` `~proplot.axes.Axes.legend`, you can also now draw *inset* colorbars. See :ref:`Colorbars and legends` for details.
 
 The axes container class
 ========================
@@ -334,7 +338,7 @@ the "blue marble". But once these are added to cartopy, ProPlot may remove the `
 
 ..
   This is the right decision: Cartopy is integrated more closely with the matplotlib API
-  and is more amenable to further development. 
+  and is more amenable to further development.
 
 Colormaps and property cycles
 =============================

proplot/rctools.py

@@ -791,10 +791,9 @@ def backend_setup(backend=None, fmt=None):
     # Configure inline backend no matter what type of session this is
     # Should be silently ignored for terminal ipython sessions
     ipython.magic("config InlineBackend.figure_formats = ['" + fmt + "']")
-    # no notebook-specific overrides
-    ipython.magic('config InlineBackend.rc = {}')
+    ipython.magic('config InlineBackend.rc = {}')  # no notebook overrides
     ipython.magic('config InlineBackend.close_figures = True')  # memory issues
-    # use ProPlot tight layout
+    # Use ProPlot tight layout
     ipython.magic(
         "config InlineBackend.print_figure_kwargs = {'bbox_inches':None}")
 
@@ -842,11 +841,11 @@ def autosave_setup(autosave=None):
             pass
 
 
-# Call setup functions and declare rc object
-# WARNING: Must be instantiated after ipython notebook setup!
 #: Instance of `rc_configurator`. This is used to change global settings.
 #: See :ref:`Configuring proplot` for details.
 rc = rc_configurator()
+
+# Call setup functions
 backend_setup()
 autoreload_setup()
 autosave_setup()

proplot/wrappers.py

@@ -2612,6 +2612,7 @@ def legend_wrapper(
         for obj in leg.get_texts():
             if isinstance(obj, martist.Artist):
                 obj.update(kw_text)
+
     # Append attributes and return, and set clip property!!! This is critical
     # for tight bounding box calcs!
     for leg in legs: