Forum |  HardWare.fr | News | Articles | PC | Prix | S'identifier | S'inscrire | Aide | Shop Recherche
739 connectés 

  FORUM HardWare.fr
  Programmation
  Java

  [OpenAPI - Maven] Generation HTML depuis yaml OAS 3

 



 Mot :   Pseudo :  
 
Bas de page
Auteur Sujet :

[OpenAPI - Maven] Generation HTML depuis yaml OAS 3

n°2350232
Damze
Posté le 30-03-2020 à 20:15:45  profilanswer
 

:hello:  
 
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  :jap:

mood
Publicité
Posté le 30-03-2020 à 20:15:45  profilanswer
 

n°2350671
gilou
Modérateur
Modzilla
Posté le 03-04-2020 à 13:05:39  profilanswer
 

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+,


---------------
There's more than what can be linked! --    Iyashikei Anime Forever!    --  AngularJS c'est un framework d'engulé!  --

Aller à :
Ajouter une réponse
  FORUM HardWare.fr
  Programmation
  Java

  [OpenAPI - Maven] Generation HTML depuis yaml OAS 3

 

Sujets relatifs
html style recursifinterface utilisateur modifiant contenu HTML et CSS
[html] fonction scrollAfficher flux http dans page html
Intéger les data d'une image au source HTMLLire beaucoup d'images BLOB en HTML
HTML : <video> sans devoir charger toute la video avant lectureHTML / Deux repères dans une carte
[LibreOffice][Tableur] Macro pour actualiser des liens externes htmlOutil de recherche personnalisé HTML
Plus de sujets relatifs à : [OpenAPI - Maven] Generation HTML depuis yaml OAS 3


Copyright © 1997-2018 Hardware.fr SARL (Signaler un contenu illicite) / Groupe LDLC / Shop HFR