swagger2markup icon indicating copy to clipboard operation
swagger2markup copied to clipboard

Markdown interDocumentCrossReferencesPrefix not usable

Open tigerMoon opened this issue 8 years ago • 4 comments

Swagger2Markup version: 1.3.1 Spring Boot: 1.4.7

Problem description: i use Swagger2Markup to generate separate markdown doc, I just want to serve each .md file as static resource.

my config:

<swagger2markup.interDocumentCrossReferencesEnabled>true</swagger2markup.interDocumentCrossReferencesEnabled>   
<swagger2markup.interDocumentCrossReferencesPrefix>http://192.168.31.116:7390/</swagger2markup.interDocumentCrossReferencesPrefix>

generate doc:

##### Body parameter
request

*Name* : request  
*Flags* : optional  
*Type* : [PersonOperationAuth3VerifyRequest](http://192.168.31.116:7390/../http:/192.168.31.116:7390/definitions/PersonOperationAuth3VerifyRequest.md#personoperationauth3verifyrequest)

the prefix is incorrect.

tigerMoon avatar Aug 23 '17 07:08 tigerMoon

Hi, would you like to create a PR to fix it? I won't have time to work on it.

RobWin avatar Sep 04 '17 09:09 RobWin

ok, i`ll have a try.

tigerMoon avatar Sep 04 '17 10:09 tigerMoon

:+1:

RobWin avatar Sep 05 '17 08:09 RobWin

Hi. What purpose of interDocumentCrossReferencesPrefix parameter? I found code that causes the issue (file DefinitionDocumentResolverFromOperation) but I don't understand hot to fix it right. If it something like base path it will not work for file path also (will write something like "basepath/../definitions/Example.md")

MaksimMyshkin avatar Oct 20 '19 15:10 MaksimMyshkin