search

Redocly / redoc

📘 OpenAPI/Swagger-generated API Reference Documentation
https://redocly.github.io/redoc/
MIT License
23.35k stars 2.29k forks source link

Property `htmlTemplate` is not expected here. #2553

Open mykelscappin opened 3 months ago

mykelscappin commented 3 months ago

Describe the bug When executing redocly build-docs -o output.php on terminal, i get this unexpected output

[1] redocly.yaml:26:5 at #/theme/openapi/htmlTemplate

Property `htmlTemplate` is not expected here.

24 | theme:
25 |   openapi:
26 |     htmlTemplate: redoc_template/index.php
27 |

Warning was generated by the configuration spec rule.

⚠️ Your config has 1 warning.
Found redocly.yaml and using theme.openapi options

Expected behavior This error should not be happening - that configuration in redocly.yaml seems to be correct and supported as per all the documentation.

Minimal reproducible OpenAPI snippet(if possible) n/a

Screenshots n/a

Additional context n/a

AuroraJMP commented 3 months ago

I'm seeing the same with pathInMiddlePanel

tcamise-gpsw commented 3 months ago

I'm seeing this with several options after moving from 1.12.0 to 1.17.0. Was there some type of configuration overhaul? I don't see anything in the docs.

I also tried converting the setting names to kebab case as requested but same behavior

lornajane commented 2 months ago

Thanks for letting us know about this. We did change something in the config parsing - I recommend you pin to an older version for now for using existing configuration, I expect 1.14 to be a good version, but please report back if that doesn't help! We'll keep you posted with more information when we have it.

lornajane commented 1 month ago

Could you try updating your CLI versions to the latest (1.18 or 1.19), please? Let us know if you still see anything that you didn't expect to, and if possible, could you share the configuration files you are using (or a snippet)

tcamise-gpsw commented 1 month ago

This seems to work for me on 1.22. Thanks!