Closed oleg-nenashev closed 7 months ago
This documentation page provides a number of possible approaches to controlling the rendering of pages. Solution 4 might do it for you?
@fralau Indeed, option 4 works. I saw it, but didn't think it could work for inline definitions. Indeed it does: https://github.com/wiremock/wiremock.org/pull/228/commits/9fcfe90135e3fd5daee7f3b4ec747e01340b0526
Problem solved, documentation updated.
It would be nice to be able to escape Macros so that they are ignored by the engine, e.g. if they are supposed to be added to documentation as is. At least, the triple bracket for Handlebars does not work, and there are also non-fatal resolution warnings for other macros in code samples
My use-case
Error for
`{{{
in codeIn https://github.com/wiremock/wiremock.org/pull/228 I am moving the documentation for WireMock which also includes its internal Handlebars-based engine. Based on that, there might be documentation lines like the following:
And this macro gets picked up by the plugins, and it results in page rendering failure:
WARNING - A relative path to 'dotgithub/SECURITY.md' is included in the 'nav' configuration, which is not found in the documentation files. INFO - [macros] - ERROR # Macro Syntax Error
WARNING - Doc file 'download-and-installation.md' contains a relative link './running-standalone.md', but the target 'running-standalone.md' is not found among documentation files. INFO - [macros] - ERROR # Macro Syntax Error
INFO - Doc file 'participate.md' contains an unrecognized relative link '../support', it was left as is. INFO - Doc file 'proxying.md' contains an unrecognized relative link '../api/#tag/System/paths/~1__admin~1settings/post', it was left as is. INFO - [macros] - ERROR # Macro Syntax Error
INFO - [SASS] Build CSS "assets/stylesheets/extra-style.hiztdwb7.min.css" from "extra_sass/style.css.scss"