Force docutils <0.13.1

[SylvainCorlay]

Docutils 0.13.1 which was just released breaks nbsphinx because of sphinx-doc/sphinx#3212

The issue seems to have been fixed in sphinx master since sphinx-doc/sphinx#3217 but until a new version of sphinx is released, we need to force docutils<0.13.1.

[mgeier]

Would the long-term solution (after a few new Sphinx releases) be to force sphinx>=1.5.1 and remove the limitation on docutils?

[mgeier]

Note that there is a bug in sphinx-doc/sphinx#3217, see sphinx-doc/sphinx#3217 (comment).

[mgeier]

Would it work if we (after the release of Sphinx 1.5.1) use sphinx!=1.5?

There is another breaking change (see #78) which will hopefully be fixed in sphinx-doc/sphinx#3224.

[SylvainCorlay]

Would the long-term solution (after a few new Sphinx releases) be to force sphinx>=1.5.1 and remove the limitation on docutils?

That is right, but in the mean time, the current setup breaks RTD builds with sphinx.

[SylvainCorlay]

Would it work if we (after the release of Sphinx 1.5.1) use sphinx!=1.5?

No idea :)

[mgeier]

I'll undo this in #79. If there are objections, please comment there.

[mpacer]

Sphinx 1.5.1 doesn't include the fix, it won't be available until Sphinx 1.5.2.

[mgeier]

@michaelpacer Are you talking about sphinx-doc/sphinx#3217 not being available in Sphinx 1.5.1?

Or rather about sphinx-doc/sphinx#3224?

[mpacer]

Ah, I'd thought they were related. But I was referring to the discussion in sphinx-doc/sphinx#3224 <sphinx-doc/sphinx#3224> describing the fix as not available in 1.5.1.

…

On Fri, Dec 16, 2016 at 09:00 Matthias Geier ***@***.***> wrote: @michaelpacer <https://github.com/michaelpacer> Are you talking about sphinx-doc/sphinx#3217 <sphinx-doc/sphinx#3217> not being available in Sphinx 1.5.1? Or rather about sphinx-doc/sphinx#3224 <sphinx-doc/sphinx#3224>? — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#77 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/ACXg6NX7TDizrWxFcIQYr-qDw2ddkhyEks5rIsO0gaJpZM4LJzdv> .

[mgeier]

Thanks for the clarification.

AFAIK, the two issues are not related, they just happened to break at the same Sphinx version.

The first one should be resolved in Sphinx 1.5.1, the second one will hopefully be fixed with #85.