List of parameters overflows 'Parameter:' in Alabaster theme when napoleon 'Returns:' statement spans two or more lines

[benjaminweb]

Problem

See how the list of parameters overflows 'Parameters:' caption.

That occurs when 'Returns:' or 'Raises:' (sphinx.ext.napoleon) spans on multiple lines.
It starts with two lines to occur. The left-indent increases with each subsequent line.

Procedure to reproduce the problem

  $ unzip alabaster.zip # see below for attached file
  $ cd albaster/doc
  $ make html
  $ open _build/html/index.html

Expected results

The list of parameters should begin after the colon of 'Parameters:' like here:

Reproducible project / your project

See alabaster.zip.

Environment info

• OS: Mac OS X El Capitain 10.11.6 (15G1212)
• Python version: 3.5.2
• Sphinx version: 1.4.9+
• Used extensions: sphinx.ext.autodoc, sphinx.ext.napeleon

[RobRuana]

Thanks for the report! I'm looking into it!

[RobRuana]

It looks like this issue is a direct result of this pull request, because the <th> element is inheriting its hyphens attribute from its parent <dd> element.

Does anyone object to me adding a more specific rule in basic.css to fix this issue for field names?

Something like this: (manual is the default value for hyphens)

.field-name {
    -moz-hyphens: manual;
    -ms-hyphens: manual;
    -webkit-hyphens: manual;
    hyphens: manual;
}

[RobRuana]

As an aside, thank you for the excellent bug report. Very clear, plus included a reproducible product! Excellent!

[benjaminweb]

@RobRuana Thanks for your timely fix. I confirm the complete resolution of the reported problem.

[bitprophet]

Belatedly, I just ran into this (was tracking under sphinx-doc/alabaster#95) and independently confirmed the same cause/effect. 👍