Redocly/redoc

Property `htmlTemplate` is not expected here.

mykelscappin opened this issue · 6 comments

mykelscappin commented

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

I'm seeing the same with pathInMiddlePanel

tcamise-gpsw commented

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

  • 👍1
lornajane commented

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.

  • 👍1
lornajane commented

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

This seems to work for me on 1.22. Thanks!