J'ai un soucis depuis plusieurs jours et je n'arrive pas à m'en sortir malgré la tonne de documentation que je trouve sur le net.  
 
J'ai un projet Java déjà existant sous Maven, fonctionnant avec Jaxrs. Je voudrais ajouter swagger dans le worflow pour pouvoir avoir une documentation à jour, sans avoir besoin de modifier des documents Words.
Bref. J'ai réussi à générer automatiquement un fichier yaml avec le plugin "swagger-maven-plugin".  
Cependant je n'arrive pas à convertir ce fichier dans un format "offline" sous Maven tel que PDF ou HTML.  
Je trouve beaucoup d'outils en ligne, mais j'ai un besoin offline (pas de dépendance d'un site web externe)
 
J'étais parti sur swagger2markup, sauf que ce dernier n'est pas compatible en OpenApi v3.
J'essaie swagger-codegen-maven-plugin en version 3, mais je n'arrive pas à bien le configurer, et j'ai la sensation qu'il est plutôt orienté pour faire un mockup depuis un fichier de specifications et pas un html.  
 
Si vous avez des pistes je suis preneur, je suis à court d'idées.
 
Merci  

Comme ils semblent avoir pas mal progressé sur la question : https://github.com/Swagger2Markup/s [...] issues/340
J'essaierais de me builder une version SNAPSHOT, a jour de la branche avec les changements indiqués a la fin du lien, du plug-in et je croiserais les doigts.
 
Alternativement, est-ce que jaxrs-analyzer-maven-plugin (cf http://www.adam-bien.com/roller/ab [...] gger_json) collerait ? auquel cas j'esaierais jaxrs-analyzer-maven-plugin + asciidoctor-maven-plugin
 
A+,