On 09/01/17 15:02 +0100, Andreas Jaeger wrote:
On 2016-12-12 09:22, Flavio Percoco wrote:On 11/12/16 13:32 +0100, Flavio Percoco wrote:On 09/12/16 17:20 +0100, Flavio Percoco wrote:Greetings,Some docs jobs seem to be broken by the latest (or not?) docutils release. The breakage seems to be related to the latest addition of the bages patch. The docs generation doesn't like to have remote images. It used to be a warning but it seems to have turned into an error now. While this is reported and fixed upstream, we can workaround the issue by tagging the image as remote. An example of this fix can be found here: https://review.openstack.org/#/q/topic:readme-badge-fix Note that this is mostly relevant for projects that include the readme files in their documentation. If your project doesn't do it, you can ignore this email. That said, I'd recommend all projects to do it.Apparently this "fix" doesn't render the image, which is far from the ideal solution. Hang on while we find a better fix.Ok, here's the actual "fix" for this issue. We're now skipping version 0.13.1 of docutils as that's breaking several docs dates. if your project is using the requirements constraints, you should not be hitting this issue. However, if your project isn't using the upper constraints, then you may want to do something similar to this[0][1]. This issue has been reported upstream [2] [0] https://review.openstack.org/#/c/409630/ [1] https://review.openstack.org/#/c/409529/ [2] https://sourceforge.net/p/docutils/bugs/301/I see that upstream has closed the issues with "Fixed in Sphinx 1.5.1". Should we update Sphinx to 1.5.1? Anybody wants to go for it? Right now, the global requirements file has: global-requirements.txt:sphinx>=1.2.1,!=1.3b1,<1.4 # BSD
Happy to help here, Flavio -- @flaper87 Flavio Percoco
signature.asc
Description: PGP signature
__________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: [email protected]?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
