Regression in reference rendering in scikit-image gallery examples

[soupault]

Describe the bug
Hi!
There is a regression in the rendering of the references.
Built with Sphinx 1.7.0:

Built with Sphinx 2.0.0 (1.8.0 and later versions are, probably, also affected):

To Reproduce
Steps to reproduce the behavior:

$ git clone https://github.com/scikit-image/scikit-image
$ cd scikit-image
$ pip install all the requirements from ./requirements
$ pip install .
$ cd doc
$ make html
$ open build/html/auto_examples/applications/plot_haar_extraction_selection_classification.html

Environment info

• OS: Ubuntu 18.04 / Mac 10.14.4
• Python version: 3.6.8
• Sphinx version: see above
• Sphinx extensions:

'sphinx_copybutton',
'sphinx.ext.autodoc',
'sphinx.ext.mathjax',
'numpydoc',
'doi_role',
'sphinx.ext.autosummary',
'sphinx.ext.intersphinx',
'sphinx.ext.linkcode',
'sphinx_gallery.gen_gallery'

• Extra tools: any browser

Additional context

• References formatting is broken in plot_segmentations scikit-image/scikit-image#3853

[jfbu]

I doubt this is core Sphinx issue. Have you tried obtaining a small project demonstrating the issue without numpydoc for example?

[soupault]

@jfbu I have tried several different versions of numpydoc and the issue remained.

Hmm... Would it help if I attach also the generated html pages from the examples above?

[jfbu]

@soupault I don't know, your problem reminded me of numpy/numpydoc#169 and if it is problem of interaction of numpydoc with current Sphinx, it should primarily be asked at numpydoc.

[jfbu]

It is too complicated to test with your big project. After installing all requirements I get

ImportError: Python is not installed as a framework. The Mac OS X backend will not be able to function correctly if Python is not installed as a framework. See the Python documentation for more information on installing Python as a framework on Mac OS X. Please either reinstall Python as a framework, or try one of the other backends. If you are using (Ana)Conda please install python.app and replace the use of 'python' with 'pythonw'. See 'Working with Matplotlib on OSX' in the Matplotlib FAQ for more information.

which apparently originates in matplotlib installed via pip. Please try to produce some small project with the error so that it can be tested.

[tk0miya]

There are two difference to my eyes. One is layout (gray bar is shown!). And another is back references are shown. Did you say which is unexpected?
I think this has came from the change of HTML writer. I guess you can see the original behavior with html4_writer = True option (And you will see same result even with Sphinx-1.8 if experimental_html5_writer = True).

If you mean first one is strange. Your theme does not support HTML5 mode. So please modify your theme or use HTML4 writer.

[tk0miya]

I'm closing this now because no updates.
Please feel free to reopen if you're still in trouble.
Thanks,