DOC: More details about IPython config

Author: mgeier

doc/code-cells.ipynb

@@ -284,8 +284,8 @@
     "The output formats for Matplotlib plots can be customized.\n",
     "You'll need separate settings for the Jupyter Notebook application and for `nbsphinx`.\n",
     "\n",
-    "If you want to use SVG images for Matplotlib plots, add this line to your IPython configuration file in your profile directory\n",
-    "(typically `~/.ipython/profile_default/ipython_kernel_config.py`):\n",
+    "If you want to use SVG images for Matplotlib plots,\n",
+    "add this line to your IPython configuration file:\n",
     "\n",
     "```python\n",
     "c.InlineBackend.figure_formats = {'svg'}\n",
@@ -297,7 +297,8 @@
     "c.InlineBackend.figure_formats = {'svg', 'pdf'}\n",
     "```\n",
     "\n",
-    "If you want to use the default PNG plots or HiDPI plots using `'retina'`, make sure to set this:\n",
+    "If you want to use the default PNG plots or HiDPI plots using `'png2x'` (a.k.a. `'retina'`),\n",
+    "make sure to set this:\n",
     "\n",
     "```python\n",
     "c.InlineBackend.rc = {'figure.dpi': 96}\n",
@@ -306,13 +307,25 @@
     "This is needed because the default `'figure.dpi'` value of 72\n",
     "is only valid for the [Qt Console](https://qtconsole.readthedocs.io/).\n",
     "\n",
+    "If you are planning to store your SVG plots as part of your notebooks,\n",
+    "you should also have a look at the `'svg.hashsalt'` setting.\n",
+    "\n",
+    "For more details on these and other settings, have a look at\n",
+    "[Default Values for Matplotlib's \"inline\" Backend](http://nbviewer.jupyter.org/github/mgeier/python-audio/blob/master/plotting/matplotlib-inline-defaults.ipynb).\n",
+    "\n",
+    "The configuration file `ipython_kernel_config.py` can be either\n",
+    "in the directory where your notebook is located\n",
+    "(see the [ipython_kernel_config.py](ipython_kernel_config.py) in this directory),\n",
+    "or in your profile directory\n",
+    "(typically `~/.ipython/profile_default/ipython_kernel_config.py`).\n",
     "If you don't know your IPython profile directory, use this command:\n",
     "\n",
     "    python3 -m IPython profile locate\n",
     "\n",
-    "If you want to make this work on https://mybinder.org/,\n",
-    "just create a file with those settings in a file named\n",
-    "[.ipython/profile_default/ipython_kernel_config.py](../.ipython/profile_default/ipython_kernel_config.py) in your repository.\n",
+    "A local `ipython_kernel_config.py` in the notebook directory\n",
+    "also works on https://mybinder.org/.\n",
+    "Alternatively, you can create a file with those settings in a file named\n",
+    "`.ipython/profile_default/ipython_kernel_config.py` in your repository.\n",
     "\n",
     "To get SVG and PDF plots for `nbsphinx`,\n",
     "use something like this in your `conf.py` file:\n",
@@ -379,7 +392,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "If you want to use PNG images, but with HiDPI resolution, use the special `'retina'` format (which also looks nice in the LaTeX output):"
+    "If you want to use PNG images, but with HiDPI resolution,\n",
+    "use the special `'png2x'` (a.k.a. `'retina'`) format\n",
+    "(which also looks nice in the LaTeX output):"
    ]
   },
   {
@@ -388,7 +403,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "%config InlineBackend.figure_formats = ['retina']"
+    "%config InlineBackend.figure_formats = ['png2x']"
    ]
   },
   {