swagger2markup icon indicating copy to clipboard operation
swagger2markup copied to clipboard

Grouping by TAG for OpenAPI v3.0 is ignored

Open micobarac opened this issue 3 years ago • 0 comments

I have created a fork of swagger2markup-maven-plugin and modified it to execute OpenAPI converter, but, grouping by TAG never happens...

This is my configuration:

                <configuration>
                    <swaggerInput>${project.basedir}/target/swagger/swagger.json</swaggerInput>
                    <outputDir>${project.basedir}/target/docs/asciidoc</outputDir>
                    <config>
                        <swagger2markup.markupLanguage>ASCIIDOC</swagger2markup.markupLanguage>
                        <swagger2markup.pathsGroupedBy>TAGS</swagger2markup.pathsGroupedBy>
                        <swagger2markup.generatedExamplesEnabled>true</swagger2markup.generatedExamplesEnabled>

                        <swagger2markup.extensions.dynamicOverview.contentPath>${project.basedir}/src/docs/asciidoc/extensions/overview</swagger2markup.extensions.dynamicOverview.contentPath>
                        <swagger2markup.extensions.dynamicDefinitions.contentPath>${project.basedir}/src/docs/asciidoc/extensions/definitions</swagger2markup.extensions.dynamicDefinitions.contentPath>
                        <swagger2markup.extensions.dynamicPaths.contentPath>${project.basedir}/src/docs/asciidoc/extensions/paths</swagger2markup.extensions.dynamicPaths.contentPath>
                        <swagger2markup.extensions.dynamicSecurity.contentPath>${project.basedir}src/docs/asciidoc/extensions/security/</swagger2markup.extensions.dynamicSecurity.contentPath>

                        <swagger2markup.extensions.springRestDocs.snippetBaseUri>${project.basedir}/target/docs/asciidoc/snippets</swagger2markup.extensions.springRestDocs.snippetBaseUri>
                        <swagger2markup.extensions.springRestDocs.defaultSnippets>true</swagger2markup.extensions.springRestDocs.defaultSnippets>
                    </config>
                </configuration>
include::{generated}/overview.adoc[]
include::example.adoc[]
include::{generated}/paths.adoc[]
include::{generated}/security.adoc[]
include::{generated}/definitions.adoc[]

Tags are only appended to overview.adoc like this:

== Tags
User JWT::Public users::Account::Users::

It even breaks my layout by not adding page break for next document (example.adoc):

image

image

Debugging the plugin, I can see that pathsGroupedBy configuration is set fine to TAGS, but the transformation never happens.

micobarac avatar May 07 '22 10:05 micobarac