markdown/rst: Support __map_ and nested parameters #164
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This closes #118 and closes #126.
I had to write a custom jinja2 filter
valid_string_cpp
to create valid c++ string literals for multi-line descriptions.This also adds rudimentary support for the default config:
Would there be any possibility to add a description to a top-level of the nested structure? I didn't manage to write correct yaml syntax for that. Maybe this would have to be solved with a new type "struct", just for documentation purposes?
![image](https://private-user-images.githubusercontent.com/3367244/293115545-8faa9dc0-5341-4576-a5c7-a59e6ad95c29.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjA3MTAwMDgsIm5iZiI6MTcyMDcwOTcwOCwicGF0aCI6Ii8zMzY3MjQ0LzI5MzExNTU0NS04ZmFhOWRjMC01MzQxLTQ1NzYtYTVjNy1hNTllNmFkOTVjMjkucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDcxMSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA3MTFUMTQ1NTA4WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NzFiM2E4YzcxOWFkMTdiZmU4OTU1ZjExNzczYjdlM2ExMTY2MTdmMTU1YzM3MzBlY2M4M2Q0NDZjNWEwYmUxNyZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.bG7gHLqZ5gCEM8hwGAIHUTD8zuRP9SP0Q2Pla71QKZg)
Example is the description of "constraints" here: