zserio icon indicating copy to clipboard operation
zserio copied to clipboard

HTML: Adhere to multi-line indention in zserio file

Open fklebert opened this issue 2 years ago • 2 comments

Currently the HTML documentation emitter does not adhere to multi-line indention used in the zserio schema file.

zserio

gets emitted as

html

and is not readable any longer without having to scroll to the right in the HTML box.

fklebert avatar Mar 08 '23 09:03 fklebert

Maybe another indention issue can also be fixed within this issue:

The documenation emitter currently aligns all field names at the longest structure name which can also cause some readability issues.

zserio: grafik

HTML: grafik

Fixing this by indenting the schema does not lead to any change. So if the multiline indention in the zserio code would be followed, we could fix it like this:

grafik

fklebert avatar Mar 08 '23 10:03 fklebert

Thanks for pointing this out. We will investigate the possibilities how to solve this.

The main problem is that our grammar parser swallows up all white spaces before parsing starts. So currently, generators do not have any clue about new lines in schema.

mikir avatar Mar 08 '23 10:03 mikir