I am incorporating a Swagger generated docs within a documenter, which looks promising:
However, I have stumbled on a blocking issue where the code above works only if the swagger is loaded before the require.min.js is loaded, but the user assets provided to makedocs in format argument are loaded only afterwards. The code that renders the page is as follows and is included with @raw html:
A simple solution I see is that user asset_links in render_head function could be loaded before requirejs_cdn, which would only involve reordering.
Another more sophisticated approach is to make SwaggerUI to be integrated in the same way as higlighting and math rendering is. This involves understanding how requirejs works, documenter internals which is more complex task for which I can’t allocate time.
I am incorporating a Swagger generated docs within a documenter, which looks promising:
However, I have stumbled on a blocking issue where the code above works only if the swagger is loaded before the
require.min.js
is loaded, but the user assets provided tomakedocs
in format argument are loaded only afterwards. The code that renders the page is as follows and is included with@raw html
:A simple solution I see is that user
asset_links
inrender_head
function could be loaded beforerequirejs_cdn
, which would only involve reordering.Another more sophisticated approach is to make SwaggerUI to be integrated in the same way as higlighting and math rendering is. This involves understanding how
requirejs
works, documenter internals which is more complex task for which I can’t allocate time.