responseModel from api declaration is not rendered about swagger2markup HOT 13 CLOSED

Thx.
Yes, the whole Swagger Model/Definitions rendering must be refined in swagger2markup.

from swagger2markup.

+1 vote for this feature.

from swagger2markup.

+1

from swagger2markup.

Hi sry. I have much to do at work.
I hope I will have time soon.
PRs welcome ;-)

from swagger2markup.

Fixed in Version 0.2.3

from swagger2markup.

Thanks for the update. I tried the updated code and see that that there are now links to definitions in the Responses table. However the links are to anchors in the same file, while the Definitions appear to be a separate file.

from swagger2markup.

Thx. @yzatslinear I would like to know your opinion. Do you think it even makes sense to create separate files or would you prefer one file.
As a workaround you can use the method asString(). See readme example. And use Asciidoctorj directly.

from swagger2markup.

I think a single file would be OK -- I'm not aware of any limitations this would present.

from swagger2markup.

@yzatslinear The approach with two files is to create an index.adoc which contains:

:doctype: book
:toc: left
:toclevels: 2
:numbered:
:sectlinks:
:sectanchors:

include::paths.adoc[] 
include::definitions.adoc[] 

and run AsciiDcotorJ (or the Gradle plugin). See build.gradle file as an example:

asciidoctor {
    sources {
        include 'index.adoc'
    }
    backends = ['html5', 'pdf']
    attributes = [
            doctype: 'book',
            toc: 'left',
            toclevels: '2',
            numbered: ''
    ]
}

The anchors in HTML work then. Unfortunately PDF seems to have a problem. This must be a bug in org.asciidoctor:asciidoctorj-pdf

I will include the index.adoc in version 0.2.4

from swagger2markup.

I created an issue regarding the PDF issue.
asciidoctor/asciidoctorj#290

from swagger2markup.

Thanks @RobWin,
You say above that you include index.adoc into 0.2.4, but it doesn't appear it made it in ?

from swagger2markup.

The index.adoc is in /src/docs/asciidoc/
If you run the Gradle asciidoctor task, it creates an index.html in /build/asciidoc
The index.doc is not created automatically, because this concept does not exists in Markdown.

from swagger2markup.

Ah, makes sense. Thanks!

from swagger2markup.