aa7cd4f5af
* [docs] Upgrade to Docusaurus 2 Due to formatting issues with Docusaurus 1 and code blocks, and upcoming 4.3 and 5.0 releases, this is an upgrade to have more control over formatting and other functionality. This adds behavior to have light/dark themes. As a consequence of upgrading, columnar format on ul element in generated generator docs had to be moved to css. This will not impact users viewing the markdown on GitHub because it didn't display the column format. This upgrade should improve syntax highlighting and performance. * Fix user page layout, choose theme with clear diff colors
1.5 KiB
| id | title |
|---|---|
| faq-extending | FAQ: Extending |
How do I use my own Java models?
How do I disable certificate verification?
Please add -Dio.swagger.v3.parser.util.RemoteUrl.trustAll=true when generating the code.
How do I skip files during code generation?
OpenAPI Generator has a built-in ignore file processor.
For example, to skip git_push.sh, one can create a file named .openapi-generator-ignore in the root of the output directory with the contents:
# Prevent generator from creating these files:
git_push.sh
The ignore file works just like .gitignore, and it is auto-generated by default.
If you need this functionality on initial generation, you can provide the option --ignore-file-override (CLI) or ignoreFileOverride (Maven and Gradle plugins) with a value targeting any existing file. The contents of that file will be evaluated relative to the output directory.
How can I customize the auto-generated code?
Variants:
- "How can I add a header/footer to generated code?"
- "How can I add my own logging to generated code?"
- "How can I add my license to the top of files?"
OpenAPI Generator supports user-defined templates without need to recompile the artifact. We also support custom generators (templates and logic) if those generators are accessible on the classpath.
See templating: Modifying Templates and customization docs for more details.