search

PaloAltoNetworks / docusaurus-openapi-docs

🦝 OpenAPI plugin for generating API reference docs in Docusaurus v3.
https://docusaurus-openapi.tryingpan.dev
MIT License
695 stars 233 forks source link

Incorrect rendering when referencing data from schema #907

Open adrianrevilla009 opened 2 months ago

adrianrevilla009 commented 2 months ago

Problem with Generating Swagger Files There is an issue when generating Swagger files that use schemas referenced by other YAML files. This problem leads to compilation errors during project build due to the generation of empty tags in .mdx files, which cannot be rendered.

Example of Issue common-schema.yaml image image image image

operative.yaml image image image image

Example of the generated .mdx file, with some of the mentioned empty tags. image

Displayed error when compiling server. image

sserrata commented 2 months ago

Hi @adrianrevilla009, can you share a copy or code snippet of the OpenAPI spec to try to reproduce the issue? Thanks!

sserrata commented 2 months ago

Also, can you provide the version of the plugin and Docusaurus you are attempting to use? Without that, it's difficult to repro or provide a possible fix. Thanks.