sphinx-contrib / redoc

ReDoc powered OpenAPI (fka Swagger) spec renderer for Sphinx.
https://sphinxcontrib-redoc.readthedocs.io/
BSD 2-Clause "Simplified" License
33 stars 20 forks source link

server url is not correct #29

Closed kadogo closed 5 years ago

kadogo commented 5 years ago

Hello,

After running "make html" if I look at the documentation I have the next server URL

http://demo-custom.fusiondirectory.org/login

But normally it must be "http://demo-custom.fusiondirectory.org/fusiondirectory/rest.php/login". From where come the server url ?

Cheers.

ikalnytskyi commented 5 years ago

Hey @kadogo,

Can you give more details please? I'm not sure I understand what server URL you are talking about. Is it a one from OpenAPI spec? Where exactly a wrong URL is shown?

kadogo commented 5 years ago

Hello @ikalnytskyi

It's the URL that is shown in the documentation that it's wrong.

In the openapi.yaml (http://demo-custom.fusiondirectory.org/fusiondirectory/rest.php/openapi.yaml ) I see the following informations.

servers:
- url: https://demo-custom.fusiondirectory.org/fusiondirectory/rest.php

So I think that normally it would show https://demo-custom.fusiondirectory.org/fusiondirectory/rest.php/login and not http://demo-custom.fusiondirectory.org/login

kadogo commented 5 years ago

At end it work now that I use the latest standalone version of redoc

redoc_uri = 'https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js'
ikalnytskyi commented 5 years ago

@kadogo sorry for not responding so long. As I understand it now, the problem is in redoc itself. ReDoc v2 is in RC state now. Once it's release, I'll update this package to bundle the latest version of ReDoc.

Closing this issue now because the workaround is to explicitly use newer version.