DOC: More details about IPython config

Author: mgeier

doc/code-cells.jupyter

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