Issues/193 fix all todos in html export

[jpraetorius]

This not only addresses the Examples mentioned in #193 but additionaly

• exports Definitions
• adds Examples of fields in the Models section (code was there but never did anything)
• exports nested fields of fields in the Models section. This currently only goes one level deep, as it already is a proper pain without partials ;)

[jpraetorius]

This is how things look like

[simonharrer]

jinja partials would be awesome

[simonharrer]

layout of the flags definition seems broken

[jpraetorius]

layout of the flags definition seems broken

That was a simple showcase to test out how enum would render. It doesn't have any other properties defined that would go in the third column. This is how it would be with some more content (but we can also try to move the enums to a different place)

[jochenchrist]

I'd put them into the description column, as the enum list could become quite long. To reduce abstraction, maybe I'd call them "Enum" instead of "Allowed values"?

[jpraetorius]

We can do that, I just don't really like how that last column then is the funny grab bag of all kinds of individual divs stacked on top of each other that may or may not be there – there's no real structure to it for the reader to grasp

[jpraetorius]

So, here we go:

• introduced partials and theoretically fields now nest as deep as they are defined (I've only tried it two levels deep)
  • I'm not a 100% happy with how that is presented, some sort of collapse or different background shading would be good I think, but all of that is complicated to do with a table
• named enums enums and moved them into the description column. I've tried to make the labels stand out a bit more, so the contents of that column are a bit easier to parse
• moved all of the other blocks into partials, to keep the main template a bit more slim

[jochenchrist]

The partials are a bit dangerous, as you need to remember to add them (as data files) to the MANIFEST.in

[jochenchrist]

The partials are a bit dangerous, as you need to remember to add them (as data files) to the MANIFEST.in

Added them to the MANIFEST. in file

[jochenchrist]

Thanks for your contribution. Happy to merge :)